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Purpose 

This Lab Setup Guide provides directions for installing, preparing, and verifying the lab 
hardware and software in preparation for conducting a class of course WB284 / VB284. 

The Requirements sections of this document may also be used to determine the specific 
hardware and software needed to conduct a class. 
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Lab setup guide overview 


The purpose of this lab setup guide is to assist the classroom preparer in setting up the 
WB284 / VB284 classroom lab environment. This guide is separated into two parts: 

• “Setting up the lab environment using a VMware image” on page 3 

• “Installing the lab environment manually (non-VMware)” on page 17 

The classroom preparer only needs to complete one of the above parts to complete the 
classroom lab environment. 


r 



Important 


It is strongly recommended that every attempt be made to use the VMware image. If a 
manual installation is required, a WebSphere Education representative should be 
contacted beforehand to discuss this solution. 




Keep in mind that the instructor will not have sufficient time to manually install the software 
needed for the lab exercises if the classroom in not properly prepared for the first day. 


V. 
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Setting up the lab environment using a VMware 
image 


For an instructor-led training (ILT) classroom delivery, the classroom preparer is 
responsible for preparing: 


Instructor or student 
workstation 

How many 
workstations 

Per how many 
students 

Notes 

instructor 

one 

n/a 


student 

one 

N 

One computer for N students 

student 





Each student workstation and the instructor workstation will host a VMware virtual 
machine, pre-configured for the lab exercises. 

The following tables list the hardware, software, and network requirements needed to set 
up a lab to support course WB284 / VB284. 


Hardware requirements 


This section lists the recommended hardware requirements for a student workstation. 


Tier 

code 

Processor type and 
speed 

Minimum 

memory 

Minimum free 
hard disk space 

Display 

resolution 

65 

Intel Pentium 4 3.0 GHz or 
faster 

3.0 GB 

40 GB 

1024 x 768 pixels 


r 



Important 




Ensure all nonessential software installed on the machine is set to not start automatically. 
The above memory requirement assumes the host operating system requires no more than 
512 MB memory and all of the remaining memory will be available to the VMware image. 


If you are unsure whether your classroom environment meets the specified hardware 
requirements, contact your WebSphere Education representative immediately. The 
performance of the lab exercises will be severely affected if the classroom systems do not 
meet the stated requirements. 


V. 
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Software requirements 


This section lists the software needed to prepare the lab environment. When preparing for 
a class, be sure you have the correct number of licensed copies of any non-IBM software. 


Software product 

Version 

Licensing requirement 

Microsoft Windows XP 

Service Pack 2 or greater 

Site must provide sufficient 
licenses for private offerings. 

VMware Player 

2.0.5 or later 

Site must satisfy the end-user 
license agreement. 


r 



Important 




Ensure all nonessential software installed on the machine is set to not start automatically. If 
non-essential software is running, performance problems may be caused because there 
may be insufficient memory available to support both the host operating system and 
VMware image. 


VMware Player 2.0.5 or later is supported. 


Administrator-level privileges are required to install the VMware Player software. 






Network requirements 

This section specifies the network requirements for the lab environment. 


Network connectivity required 

No 

Internet connectivity required 

No 

DHCP required 

No 

Fixed IP addresses required 

No 


Skills required to set up the lab 

The following specialized skills are required by the classroom preparer to set up the lab 
environment: 

• Install Windows applications on Microsoft Windows XP 

• Verify user access rights on Microsoft Windows XP 

• Configure network adapter drivers on Microsoft Windows XP 
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Classroom preparation process overview 


Begin classroom preparation 

i. 

Does the classroom have 
sufficient computers 
meeting the hardware and 
software requirements? 


Yes 


i 


Do you have sufficient 
administrator-level access 
on each workstation? 


Yes 


I 


Are you able to install the 
VMware Player software 
successfully? 


Yes 


I 


Are you able to 
uncompress and verify the 
virtual machine image for 
this course? 


Yes 


i 


Classroom preparation complete 



Workstation setup overview 

The following classroom setup instructions are separated into the following sections: 

• Section 1 . Preparing the base workstations: This section describes how to configure the 
physical (host) student machines with the proper operating system, network, and 
software settings. 

• Section 2. Installing VMware Player: This section describes how to download, install, 
and configure VMware Player. 
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• Section 3. Installing the VMware images: Describes how to uncompress, load, and 
verify the virtual (guest) student computing environment. The guest system runs as a 
virtual computer on the physical, host system. 


If you need additional information on virtual machines, see “Appendix. Introduction to 
virtual machines” on page 53 which provides an introduction to the concept of virtual 
machines and the VMware player application. 


Section 1: Preparing the base workstations 
General lab environment information 

The ideal lab environment is to have all student machines connected to the same LAN with 
TCP/IP correctly configured so that machines can connect to each other using their host 
names. 

If no LAN adapter is available, the Microsoft Loopback Adapter should be configured as the 
default LAN adapter with a private TCP/IP address so that the TCP/IP stack will be active. 

Refer to the Microsoft Knowledge Base for information on how to configure this option. 

Operating system setup instructions 

Ensure the operating system is set up correctly: 

1 . Ensure the operating system listed in the software requirements section is installed. 

2. Ensure the local user account has sufficient administrator-level privileges to install 

the VMware Player application. 

a. From the Windows Start menu, open Control Panel > Administrative Tools > 

Computer Management. 

b. In the Computer Management console, expand 

Computer Management (Local) > System Tools > Local Users and Groups 
> Users. 
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c. Double-click the user account that is currently logged in. 


Computer Management 


File Action View Window Help 

-► m H0 ®ji @ 


Name 

| Full Name 

cS Guest 


AS Help Assistant 

Remote DeskJtop Help Assi. . . 

J^5UPPGRT_38... 

CN=Microsoft Corporation. . . 

-fi Administrator 


I jJj Computer Management (Local) 

- •jjjk System Tools 
+ MJ Event Viewer 
+ a J Shared Folders 
"3 Local Users and Groups 

Q Groups 

+ ^ Performance Logs and Alerts 
L -J|| Device Manager 

d. In the user properties window, switch to the Member Of tab. 

. e. Verify that the currently logged in user account is a member of an 
administrator-level user group. 


Administrator Properties 


General Member Of j Profile | 

Member of: 
pS Administrators 

f. Close the user properties window and the Computer Management console. 


r Note ^ 

Contact the computer network administrator to determine the user access rights available 
to students on each classroom computer. Most corporations enforce network domain 
policies to restrict access privileges on each individual desktop computer. You might have 
to request administrator-level access in order to install additional software on each 
computer. 

Keep in mind that local administrator-level access will be overridden by group security 
policies on the domain controller. 

For more information, review the Windows XP Professional product documentation on user 
accounts: 

http: / /www.microsoft . com/ resources/ documentat ion/ windows /xp/ all/proddocs 
/ en-us / usercpl_overview . mspx 

V J 


Section 2: Installing VMware Player 

Perform the following steps to download, install, and configure VMware Player on each 
student and instructor workstation. 
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WebSphere Education courses require VMware Player version 2.0.5 or later. 

V J 


1 . Download the VMware Player software from the VMware product page. The steps 
below are for version 2.0.5. 

a. Open a new Web browser window. 

b. Navigate to Web address http://www.vmware.com/products/player. 

c. In the main product page, click the Download link. 

d. Click the Download link for VMware Player 2.0.5, build 109488. 


VMware Player 2.5 

Latest Version: 2.5 1 2008/09/23 1 Build: 118166 | Release Notes 



Version History 


Open Source 


VMware Player 2.0.5 

| 2008/08/28 | Build: 109488 
D own load | RBe a s e Notes 


VMware Player 2.0.4 

Version: 2.0.4 1 2003/05/29 | Build: 93057 
Download | Release Notes 


e. Review the end-user license agreement. If you do not accept the license, you 
cannot proceed with the lab setup. 
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f. Under Version History, scroll down to VMware Player 2.0.5 and select the 

Download for Windows link. 

Home > Downloads > Desktop Downloads > VMware Player 

VMware Download VMware Player 

Player 

■ Lo o ki n g to d own load VM wa re P I aye r? 

Click the "Download No w" button below to register and gain access to your binaries. 

■ Stay informed 

Be sure to read the "Release Notes"for each version prior to downloading 

■ Looking to promote VMware Player on your site? 

Please read and accept the VMware Usage Guidelines to gain access to VMware 
Player icon. 


Thank you for registering for VMware Piayer! 


You may proceed to download VMware Player below or learn in ore about VMware Player. 



_ g. Download a copy of the product to each student workstation and instructor 
machine. 

2. Install the VMware Player application. The steps below are for version 2.0.5. There 
may be differences for later versions. 

_ a. Double-click the VMware-player-2-0.5-109488.exe self-extracting archive. 

b. When the VMware Player installation wizard appears, click Next. 



c. Review the end-user license agreement. If you do not accept the license, you 
cannot proceed with the lab setup. 


© Copyright IBM Corp. 2003, 2009 Setting up the lab environment using a VMware image 9 

Course materials may not be reproduced in whole or in part 
without the prior written permission of IBM. 


Lab Setup Guide for Classroom Delivery 


d. Leave the destination folder to the default setting of 
C:\Program Files\VMware\VMware Player and click Next. 

e. Leave the configure shortcut settings to the default of Desktop, Start Menu 
Programs folder, and Quick Launch toolbar. Click Next. 

f. In the configure product page, clear the Enable the Google searchbar check 
box. Click Next. 



g. Click Install to proceed with the installation. The installation process might take 
5-10 minutes to complete. 

h. Verify that no error messages appear during product installation. 

i. Click Finish to close the installer. 
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r 



Information 




VMware Player installs additional network drivers in order to perform network address 
translation (NAT) and bridged networking. If you do not have administrator-level privileges 
on the current Microsoft Windows operating system, the installation might fail at this point. 



V J 

Section 3: Installing the VMware images 

This course uses a preconfigured computer environment, supplied by IBM WebSphere 
Education. The VMware virtual machine, also known as a virtual machine image, 
represents a self-contained computer running on your student workstation. This 
configuration eliminates the need for your classroom preparer to install course-specific 
software. 

r Y N0,e % 

For a quick introduction to VMware virtual machines, consult “Appendix. Introduction to 
virtual machines” on page 53. 

V J 
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Image information 

The following section provides information about the VMware image, including system 
requirements and logon information. 


To download the VMware image for this course, go to http://catalog.atlanta.ibm.com 
and search by course code or title. 


Image setting 

Value 

Image name 

WB282 VB282 16MAR09 XP Modeler62 ercl.O.zi 
P 

Size of uncompressed image 

11 GB 

Operating system installed 

Microsoft Windows XP 

Additional software required 

No 

Network access requirements 

Isolated (no network access) 

Network IP configuration 

Not applicable 

Network bandwidth requirements 

Not applicable 

Primary account username 

Administrator 

Primary account password 

web 1 sphere 


VMware virtual machine setup instructions 

Perform the following steps to uncompress the VMware virtual machine image onto each 
student workstation. As part of the course materials, you should have received a set of 
CD-ROM discs containing the virtual machine image. 

1 . Extract the virtual machine files onto the student workstation. 

a. Insert the first virtual machine image CD into the CD-ROM drive. 

b. Run the setup application on the root of the CD-ROM disc. 

c. When prompted, accept the default directory for the destination of the image files 

on the hard drive. 

d. Start the application to uncompress the virtual machine image files onto the hard 

drive. 

2. When prompted, remove the current CD-ROM disc and insert the next virtual 

machine image CD in sequence. 

_ 3. At the conclusion of this process, the VMware image should be built on the 

C:\vmwareimages directory. 


Image customization and environment settings 

Perform the following steps after loading the VMware virtual machine image onto each 
workstation. 

No customization steps required. 
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Verification procedures 

Use the following information to verify the installation and configurations of the student and 
instructor systems. 

_ 1 . Start the virtual machine with VMware Player. 

a. From the Windows Start menu, select Programs > VMware > VMware Player. 

_ b. In the Browse for virtual machine configuration file dialog, navigate to the 
directory where you had uncompressed the virtual machine files. (If you selected 
the default directory, then it will be C:\vmwareimages) . 

c. Select the .vmx file and click Open. 

VMware Player 



d. Wait until the Windows logon screen appears in the virtual machine. 

_ e. Log on to Windows using the following: 

• Username: Administrator 

• Password: weblsphere 

f. Make sure that the Windows desktop appears without any errors. 

2. Verify that the virtual machine has been assigned a proper IP address. 
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a. Within the virtual machine, select Run from the Windows Start menu. Make sure 
that you are performing this task within the virtual machine (guest system) and 
not the physical machine (host system). 



b. In the Run dialog, enter: and 

c. Click OK to continue. 

d. When the Windows command prompt appears, type ipconfigto list all network 
devices configured within the virtual machine. Press Enter. 

e. Verify that the Local Area Connection Ethernet adapter has received an IP 
address. 

• For virtual machines using Network address translation, the IP address should 
be in the private IP range of 192 . 1 68 .x. x 

• For virtual machines using Bridged networking, the IP address should be in the 
same range as the physical machine (host system). 


ov C:\WINDOWS\system32\cmd.exe 


C:\Documents and Sett ingsSstudent >ipconf ig 
U in do us IP Configuration 


[Ethernet adapter Local Area Connection: 

Connect ion-spec if ic DNS Suf f ix 

IP Address 

Subnet Mask 

Default Gateway 


Um ibm.com 

9 

255.255.255.0 

9.ij£_£H.i 


C:\Documents and Sett ingsSstudent 


Verifying the input language and keyboard layout 

Perform the following steps to ensure the virtual machine is set to the correct input 
language and keyboard layout. 

_ 1 . Click Start > Control Panel > Regional and Language Options. 

2. Select the Languages tab 
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3. Click Details. 

_ 4. Verify the default input language corresponds to your keyboard layout. 

5. If required, change the default input language and keyboard layout to the correct 

values. 

Optimizing the memory allocation setting for the virtual machine 

If possible, you should increase the memory allocation of the virtual machine to 
enhance performance. To do so, perform the following steps: 

1 . In the VMware Player menu bar, select Player > Troubleshoot > 

Change Memory Allocation. 

2. In the Memory dialog, adjust the amount of memory allocated to the virtual machine 

based on the total amount of physical memory available. For example, if you have 3 
GB of physical memory, allocating 2 GB to the virtual machine is recommended. 

_ 3. Click OK to accept the changes. 

4. VMware Player reminds you that the memory allocation settings take effect upon 

system reset. Click OK to close the dialog. 

5. Reset the virtual machine to apply the memory allocation changes. In the VMware 

Player menu bar, select Player > Troubleshoot > Reset. 



To access Windows Task Manager from the VMware image, press Ctrl + Alt + Insert. 

V J 

Stop ^ 

This completes the installation and customization of the lab environment using a VMware 
image. 

V J 
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Installing the lab environment manually 
(non-VMware) 


The following section provides information on how to manually create the lab environment 
that is needed to conduct the lab exercises in this course. 


Perform the manual lab setup under the following conditions only: 


• You are not allowed to install the VMware Player. 

• You tried to perform the lab setup using the VMware image and you were unable to 
successfully install the VMware Player software on the student or instructor workstation. 

• Verification of the virtual machine image settings, including network connectivity, failed. 


r 



Important 


Contact your WebSphere Education representative before attempting to perform these 
steps. 




V. 




For an instructor-led training (ILT) classroom delivery, the classroom preparer is 
responsible for preparing: 


Instructor or student 
workstation 

How many 
workstations 

Per how many 
students 

Notes 

instructor 

one 

n/a 


student 

one 

N 

One computer for N students 

student 





The following tables list the hardware, software, and network requirements needed to set 
up a lab to support course WB284 / VB284. 


Hardware requirements 


This section lists the recommended hardware requirements for a student workstation. 


Tier 

code 

Processor type and 
speed 

Minimum 

memory 

Minimum free 
hard disk space 

Display 

resolution 

65 

Intel Pentium 4 3.0 GHz or 
faster 

3.0 GB 

40 GB 

1024 x 768 pixels 


r 



Important 


If you are unsure whether your classroom environment meets the specified hardware 
requirements, contact your WebSphere Education representative immediately. The 
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performance of the lab exercises will be severely affected if the classroom systems do not 
meet the stated requirements. 

v y 

Software requirements 


This section lists the software needed to prepare the student lab environments. When 
preparing for a class, be sure to have the correct number of copies of any non-IBM 
software. 


Software product 

Version 

Licensing requirement 

Microsoft Windows XP 

Service Pack 2 or greater 

Site must provide sufficient 
licenses for private offerings. 

IBM WebSphere Business 
Modeler Advanced 

V6.2 

Site must satisfy the end-user 
license agreement. 

IBM WebSphere Business 
Modeler Publishing Server 

V6.2 

Site must satisfy the end-user 
license agreement. 

IBM Lotus Form Designer 

V3.5 

Site must satisfy the end-user 
license agreement. 

IBM Lotus Form Viewer 

V3.5 

Site must satisfy the end-user 
license agreement. 

IBM Rational RequisitePro 

V7.0.1 

Site must satisfy the end-user 
license agreement. 

IBM Rational ClearCase LT 

V7.0.1 

Site must satisfy the end-user 
license agreement. 

Internet Explorer 

V6 SP2 or later 

Site must satisfy the end-user 
license agreement. 


Network requirements 

This section specifies the network requirements for the lab environment. 


Network connectivity required 

No 

Internet connectivity required 

No 

DHCP required 

No 

Fixed IP addresses required 

No 


Skills required to set up the lab 

The following specialized skills are required by the classroom preparer to set up the lab 
environment: 

• Install Windows applications on Microsoft Windows XP 

• Verify user access rights on Microsoft Windows XP 
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• Configure network adapter drivers on Microsoft Windows XP 
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Setup instructions 

General lab environment information 

The ideal lab environment is to have all student machines connected to the same LAN with 
TCP/IP correctly configured so that machines can connect to each other using their host 
names. 

If no LAN adapter is available, the Microsoft Loopback Adapter should be configured as the 
default LAN adapter with a private TCP/IP address so that the TCP/IP stack will be active. 

Refer to the Microsoft Knowledge Base for information on how to configure this option. 


Operating system setup instructions 

Perform the following steps to install and customize the base operating system. 

1 . No customization is required for base operating system 

Software setup instructions 

Perform the following steps to install and customize software that is required in addition to 

the operating system. 

1 . Extract the WB282_ERC1 .0_J_ABFILES.zip file onto C:\ drive. Unzipping of this file 

may take up to 5 minutes. This file contains lab files necessary to perform hands-on 
lab exercises during the course. 

2. You will need to copy the following folders into the C:\ drive 

• Workspaces 

• Student Files 

• Additional Materials 

Part 1: Installing WebSphere Business Modeler V6.2 Advanced Edition 

1 . Log onto Windows as Administrator or log on using an account that is a member of 

the Administrators group. 

2. Download and extract the installation files for WebSphere Business Modeler 

Advanced Edition or insert the installation media. At the time of this writing, the 
Modeler download was an archive file named ModeierAdvanced62_win.zip. 

3. Double-click iaunchpad.exe to start the installation launchpad. 

4. Click the Install IBM WebSphere Business Modeler Advanced V6.2 link. 

5. Leave the installation package for IBM WebSphere Business Modeler Advanced 

selected and click Next. 
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6. At the program license agreement panel, select I accept the terms in the license 

agreements and click Next. 

7. At the install packages panel, leave Create a new package group selected, change 

the Installation Directory to C:\iBM\WBModeier62 and click Next. 

8. At the features panel, leave the following default options selected for WebSphere 

Business Modeler Advanced and click Next. 

9. At the summary information panel, review the target locations and features and click 

Install. 

10. When the installation is complete, select None for the option: Which of the 

following packages would you like to start? 

11 . Click Finish to exit the Installation Manager and close the launchpad. 

Part 2: Installing IBM Lotus Forms Designer V3.5 

_ 1 . Download and extract the installation files for Lotus Forms Designer or insert the 
installation media. At the time of this writing, the installation file was an archive file 
named C1KT0ML . zip or ClSL0ML.zip 

2. Locate and run the LFDesigner_35_Win32.exe file. 

_ 3. Select English (United States) and click OK. 

4. In the Welcome window, click Next 

_ 5. Select the radio button for I accept the terms in the license agreement and click 
Next. 

6. Select Add Designer to an existing IBM Software and click Next. 

_ 7. In the next screen, make sure that you select the same directory that contains 

WebSphere Business Modeler. Select the directory c : \iBM\WBModeier62 and 
click Next. 

_ 8. Click Install. The installation may take a few minutes. 

_ 9. Once installation is complete, click Finish to exit the installer. 

Part 3: Installing IBM Lotus Forms Viewer V3.5 

1 . Download and extract the installation files for Lotus Forms Designer or insert the 

installation media. At the time of this writing, the installation file was an archive file 
named ciKS9ML.zip 

_ 2. Locate and run the LFDesigner_35_Win32.exe file. 

3. Select English (United States) and click OK. 

_ 4. In the Welcome window, click Next 

5. Select the radio button for I accept the terms in the license agreement and click 

Next. 


© Copyright IBM Corp. 2003, 2009 Installing the lab environment manually (non-VMware) 21 

Course materials may not be reproduced in whole or in part 
without the prior written permission of IBM. 


Lab Setup Guide for Classroom Delivery 


6. Select Add Viewer to an existing IBM Software and click Next. 

_ 7. In the next screen, make sure that you select the same directory that contains 

WebSphere Business Modeler. Select the directory c : \iBM\WBModeier 62 and 
click Next. 

8. Click Install. The installation may take a few minutes. 

9. Once installation is complete, click Finish to exit the installer. 

Part 4: Installing Rational RequisitePro and Integration Plug-in 

This section walks you through the installation of the Rational RequisitePro Integration 
plug-in for WebSphere Business Modeler V6.2. In order for the plug-in to be enabled, you 
will first need to install Rational RequisitePro. This requires you to have the license key for 
Rational RequisitePro. 

Installing Rational RequisitePro V7.0.1 

1 . Download and extract the installation files for Rational RequisitePro V7.0.1or insert 

the installation media. At the time of this writing, the installation file was an archive 
file named ciiQLML.zip 

2. Within the directory containing installation files for Rational RequisitePro, 

double-click setup.exe to launch the installation. 

The IBM Rational RequisitePro LaunchPad window displays. 
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3. In the LaunchPad window, click Install IBM Rational RequisitePro. 
The IBM Rational Setup Wizard window displays 



4. On the first screen of the Setup Wizard, click Next. 

5. On the Deployment Method screen, verify Desktop installation from CD image is 

selected and click Next. 


■■■ 

IBM Rational Setup Wizard 

m 

Deployment Method 


Choose a deployment method for installation 


and configuration 



Deployment Method 


" Enterprise deployment [Create a network release area and 
customize it using Siteprep] 


f* Desktop installation from CD image 


< Back 

Neat > 

Cancel 

Help 



This launches the Setup Wizard from your local files. 
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6. In the Setup Wizard, click Next. 

7. Close any other applications on your computer and disable any anti-virus software. 

8. On the Product Warnings screen, click Next to proceed with installation. 


r — 

J3J IBM Rational RequisitePro - Setup Wizard 

=§J 

Product Warnings 

Please take note of the following warnings regarding installation of 
this product onto your machine. 

<0 



There are some product-specific warnings for this installation: 

STOP! Before proceeding with this install, please close all applications and 
disable anti-virus software. Check http://ibm.com/support/docview. wss?rs=203 
&context=SWD00&q1=1 1 35295 &uid=swg21 135295 for information on howto 
prevent potential system corruption. 


InstallShield 


< Back 

j Next > 

) 

Cancel 


9. In the Software License Agreement window, click Accept. 
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10. On the Destination Folder screen, accept the default installation directory 

(C:\Program Files\Rational) and click Next. 



11 . On the Custom Setup screen, accept the default features and click Next. 



12. On the next screen, click Install and wait for the product to be installed. The 
installation should take less than five minutes, depending on your system 
performance. 
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13. Click Finish when the installation is complete. 



Your will now need to obtain a license key in order to use Rational RequisitePro. Contact 
your IBM Rational Sales Representative. 

_ 14. After installation completes, the IBM Rational License Key Administrator window 
appears, along with the License Key Administrator Wizard window. 

If you do not see this application, you can start it by navigating to Start > Programs 
> IBM Rational > IBM Rational License Key Administrator. 

15. If you will be importing a Rational License File, select Import a Rational License 

File and click Next. 
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Otherwise select the appropriate option. The rest of these instructions assume that 
you have a UPD license file . 



_ 16. Click Browse, point to the location of your UPD file, and click Open. 

17. In the Confirm Import window, verify the contents of the license file and click 

Import. 


Import d License File 


m 
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18. Click OK when the file is imported successfully. 



1 9. If the Restart License Server dialog box appears, click Yes. 



20. In the IBM Rational License Key Administrator window, verify that the license 
key for Rational RequisitePro has been imported. 



21. Close IBM Rational License Key Administrator. 

22. Exit Rational RequisitePro. 

Installing the Rational RequisitePro Integration plug-in 

This installation requires you to start WebSphere Business Modeler. 

1 . Launch WebSphere Business Modeler and use any workspace. 

2. Navigate to Help > Software Updates > Find and Install. The Install wizard 

opens. 

3. Select Search for new features to install and click Next. 
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4 . On the Update sites to visit page, select the IBM Rational RequisitePro Update 
Site check box and click Finish. 



5. On the Search Results page, expand IBM Rational RequisitePro Update Site > 
RequisitePro and select IBM RequisitePro Integration Plug-in for WebSphere 
Business Modeler 6.2. 
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6. Click Next. 

7. On the Feature License page, read the license agreement and accept the 
agreement by clicking I accept the terms in the license agreement. 



8. Click Next. 

9. On the Installation page, verify the installation directory and click Finish. 
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10. Wait for the Update Manager to finish downloading the installation components. 



11 . If the Verification dialog box appears, click Install to allow this feature to be 
installed. 



After WebSphere Business Modeler has installed the Rational RequisitePro integration, a 
dialog box opens. This message recommends that you restart WebSphere Business 
Modeler. 
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In^toll/Updat? 



You Ml need to restart the IBM WebSphere Business Madder Advanced 
Version 6. I- 1 for the changes to take effect. Would you like So restart now? 



m 


12. Restart WebSphere Business Modeler by clicking Yes. 


Part 5: Installing Rational ClearCase LT server 

This also requires that you have the license key for the product. 

1 . Download and extract the installation files for Rational RequisitePro V7.0.1or insert 

the installation media. At the time of this writing, the installation file were archive files 
named ciiqiml . zip . 

2. Run the installation executable file for Rational ClearCase LT server. 



3. Click Next. 
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4. Select Rational ClearCase LT in the Rational Products list and click Next. 


Rational Setup Wizard 


Product Selection 

Choose the product to install 


1*1 

Rational* 

the software development company 


- £3 Rational Products 

<$> 


Rational ClearCase LT 


•■<§) Rational License Server 


Product Description: 

Complete software configuration 
management system for project 
workgroups. Rational ClearCase LT 
server should be installed on a single, 
dedicated server machine accessible by 
all ClearCase LT clients. 


d 


< Back 

Next > 


Cancel 

i 

Help 


5. Select the Desktop install from CD image option and click Next. 
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6. Select the Install server and client software option and click Next. 



7. Click Next on the Rational ClearCase LT — Setup Wizard screen. 


iff Rational ClearCase LT - Setup Wizard 


ill 


Rational' 

ths software development sc Tips'll 

Welcome to the Setup Wizard for Rational 
ClearCase LT 


The 5etup Wizard will install Rational ClearCase LT on your 
computer. To continue, click Next. 


WARNING: This program is protected by copyright law and 
international treaties. 

: 

1 

1 

l n 

0-1 


< Back 


Next > 


Cancel 


8. Click Next on the warning screen. 
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9. Choose the I accept the terms in the license agreement option and click Next. 



10. Accept the default destination folder and click the Next button. 


Rational ClearCase LT - Setup Wizard 


Destination Folder 

Click Next to install to this folder, or click Change to install to a 
different folder. 


Rational 1 

the software development company 


j Install Rational ClearCase LT to: 
] C:\Program Files\Rational\ 


Change... 


Rational Software 

< Back | Next > | Cancel 
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11 . Click Next on the Custom Setup screen. 



12. Click Done on the Configure Rational ClearCase screen. 
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13. Click Install on the Ready to Install screen. 


1 i'^ 1 Rational ClearCase LT - Setup Wizard 

-si 

Ready to Install the Program 

The wizard is ready to begin installation. 

Rational' 

the -software devolopmenl ECTipan^ 

Click Install to begin the installation. 


If you want to review or change any of your installation settings, click Back. Click Cancel to 
exit the wizard. 


Rational Software 


< Back 


Install 


Cancel 


14. When the installation finishes, clear both check boxes as follows: 



15. Click Finish. 
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16. A restarting request message box will show up. Click Yes. 


ft Rational ClearCase LT Installer Information 



You must restart your system for the configuration 
changes made to Rational ClearCase LT to take effect. 
Click Yes to restart now or No if you plan to restart later. 


Yes 


No 


1 7. After the restarting your computer, the firewall on your computer may be up again, 
and this will cause the Getting Started Wizard to fail. So the following special steps 
should be taken. 

18. After starting up, click Cancel to close the Getting Started Wizard. 



19. If a warning window appears saying you must restart the installation in order to 
install successfully, click OK. 


Rational ClearCase LT Getting Started Wizard 



You have not run the Rational ClearCase LT Getting Started Wizard to a successful completion. You must rerun Rational ClearCase LT Getting Started 
Wizard from the ClearCase LT Administration menu to properly configure ClearCase LT for client use. ClearCase LT operations will fail until you have 
successfully completed the Rational ClearCase LT Getting Started Wizard. 


Rerun the Rational ClearCase LT Getting Started Wizard from the ClearCase LT Administration menu. 


OK 
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20. Shut down the firewall described in Part 2 — Preparing the Setup Environment 

section. 

21 . Click Start > Programs > Rational Software > Rational ClearCase > 
Administration > Getting Started Wizard. 

22. Click Next on the Getting Started Wizard screen. 
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23. Click Next (this error message only applies to Window XP). 


Rational ClearCase LT Getting Started Wizard 




Rational" Canceling the ClearCase LT 

the aaftwan dBvoiopmBnmoinpflny G0ttinQ StSTtGCl Wizard 



© 


d 


You cannot successfully run the Rational 
ClearCase LT Getting Started Wizard logged in as 
the Local System Administrator. Log out and log 
back in as a member of an NT domain, then rerun 
the Rational ClearCase LT Getting Started Wizard 
from the ClearCase LT Administration menu. 


For the data storage created by Rational ClearCase 
LT Getting Started Wizard to be shared by multiple 
users, it must be created by a user who is logged 
into an NT domain and who shares a primary group 
in that domain with other users who will be 
accessing ClearCase LT on this server. d 


Please review and resolve these errors then rerun the 
ClearCase LT Getting Started Wizard from the ClearCase LT 
Administration menu. T o ignore these errors and continue 
anyway, click Next. 


< Back 


Next > 


Cancel 


24. Click Next to accept the default folder. 



25. Click OK in the Rational ClearCase LT Getting Started Wizard window, which states 

“The selected volume C:\ClearCaseStorage is not an NTFS volume...” 
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26. Click Next to accept the default name of the ClearCase LT VOB. 



27. Click Next to accept the default name of the ClearCase Project. 


Rational ClearCase LT Getting Started Wizard 


Create an Initial ClearCase LT Project 

Specify the name of an initial ClearCase LT Project. 


If your project requires that 
concurrent changes be made to 
flies by different project members, 
select Parallel stream project. 
Otherwise, choose Single stream 
project. 

For further information, see: 

• Planning the Project* in 
Managing Software 
Projects for Rational 


Starting UCM Project Name: 



Type of Project 

(* Single stream project 
C Parallel stream project 


< Back | Newt > | Cancel 
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28. Click Next on the Summary of ClearCase Configuration. 


Rational ClearCase LT Getting Started Wizard 


Summary of ClearCase LT System Configuration 

The following tasks are being completed to 
configure this system: 

Create the ClearCase LT storage on 'C:\ClearCaseStorage' 
Create the required ClearCase LT project VO B '\projects' 
Create a ClearCase LT source VO B named '^sources' 
Create an initial ClearCase LT project 'InitialProject' 


Click Next to configure the server with these settings, or click Back to change settings. 


< Back 


Next > 


Cancel 


29. Click Next to complete the Getting Started Wizard. 



30. Click Close to exit the Getting Started Wizard. 
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31 . Go to Start > Programs > Rational Software > Rational License Key 
Administrator. 

32. Click Cancel to close the License Key Administrator Wizard. 

33. From the menu bar of the License Key Administrator window click Settings > 
Client/Server Configuration 

34. Check the Use License Server box. 

35. Click the Add Server button. 



36. Enter localhost as the Server Name. 



37. Click OK. 

38. Go to File > Exit to close Rational License Key Administrator. 
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Part 6: Creating the VOB and view 

You will create a view and VOB (versioned object base) storage on the server that will 
contain the shared projects. 

To create a Rational ClearCase VOB, complete the following steps: 

1 . Click Start > Programs > Rational Software > Rational ClearCase > 

Administration > Create VOB. 

The VOB Creation Wizard is displayed. 
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2. Enter Test vob as follows: 



3. Click Next. 

4. Select Allow this VOB to contain multiple components. 

5. Click Finish. 
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The VOB creation confirmation is displayed. 



6. Click OK. 

The Creating VOB window is displayed. 


Creating VOB 


Summary: 

Created versioned object base. 

Host-local path: XPBASE: C:\ClearCaseStorageWOBs 

\Test_VOB.vbs 

VOB ownership: 

owner XPBASE Administrator 
group XPBAS E \N one 

VOBs have special data backup considerations. For more 
information on how to 

back up your VOB properly, see the documentation for administering 
ClearCase. 

If the backups aren't done properly, you are putting your data at risk! 

Close 


7. Click Close. 

8. To create a Rational ClearCase view, click Start > Programs > Rational Software 
> Rational ClearCase > Create View. 
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The View Creation Wizard is displayed. 


,? View Creation Wizard - Choose a Project 


*j 



Will this view be used for working on one of the 
Projects described in the ClearCase project tree? 

C* No C Yes 


Please select a project 




below: 


Properties 


< Back 


Newt > 


Finish 


Cancel 


Help 


9. Click Next. 

10. Enter C:\ClearCaseStorage\Views\test_view as the location. 



11. Click Finish. 
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1 2. Click OK to confirm. 



The Choose Elements To Load window appears. 



1 3. Select Test_VOB from the Available Elements. 
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14. Click the Add » button to choose Test_VOB to load. 



15. Click OK. 


The View Creation Status window appears. 


View Creation Status 



The Administrator Jest_view' View was successfully created. 


*j 


OK 

_ 16. Click OK. 

Now you have created a VOB in your clear case repository. 

Part 1: Installing WebSphere Business Modeler Publishing Server V6.2 

_ 1 . Log onto Windows as Administrator or log on using an account that is a member of 
the Administrators group. 

2. Download and extract the installation files for WebSphere Business Modeler 

Advanced Edition or insert the installation media. At the time of this writing, the 
Modeler Publishing Server v6.2 download was an archive file named 

PubServer6 . 2_win . zip. 
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3. Create a publishing_serverJnstallation_image directory. 


_ 4. Extract the files for each supporting product into the following subdirectories in the 
publishing_server_installation directory: 

Product 

Directory name 

WebSphere Application Server, Version 6.1.0.21 

WAS 

DB2®. Version 0.5 

DB2 

WebSphere Business Modeler Publishing Server, Version 6.2 

WPBS 

WebSphere Business Modeler Publishing Server information center 

IFC 


5. Double-click C:\publishing_server_installation\install.exe to Start the 
installation program. 

6. On the Welcome panel, review the information, and click Next to continue. 

7. On the Software License Agreement panel, review the terms of the license 
agreement, and click Accept. 

8. Click Next. The installation program performs a brief check to verify that prerequisite 
operating system software is installed on the system. 

9. On the System prerequisites check panel, review the results of the prerequisite 
check, and click Next to continue. 

10. On the Installation type selection panel, select Typical Installation, and click Next. 

11 . On the Installation directory panel, in the WebSphere Business Modeler Publishing 
Server installation location field, enter c:\iBM\PubServer as the path where 
WebSphere Business Modeler Publishing Server will be installed, or accept the 
default location. Click Next. 

12. On the WebSphere Application Server enable administrative security panel, 
complete the following steps: 

• In the User name field: wasadmin. 

• In the Password and Confirm password fields: wasadmin. 

13. For IBM DB2, you must complete the following steps on the Database configuration 
panel: 

• User name: db2admin. 

• Password: db2admin 

14. On the Installation Summary panel, review the information for accuracy before 
beginning the installation. 

15. On the Installation Results panel, review the information about the completed 
installation to verify all components and products were installed properly. 

16. Click Finish. 
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Verification procedures 

Use the following information to verify the installation and configuration of the student and 
instructor lab environments. 

_ 1 . Verify that you can open each image with the VMware Player. 

a. Double-click the VMware Player shortcut, Shortcut to Windows XP 

Professional.vmx on the desktop. 

b. Log in using the following ID and password: 

User ID: Administrator 

Password: weblsphere 

c. After you verify the image, exit the virtual machine by selecting Player > Exit. 


Stop ^ 

This completes the manual installation and customization of the lab environment 
(non-VMware image). 

V J 
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Appendix. Introduction to virtual machines 

The following section provides an introduction to the concept of virtual machines and the 
VMware Player application. 

Preface 

Virtual machines provide a separate, isolated computing environment as a computer 
program on your desktop. The virtual machine itself represents a complete computer 
system: when you power on the virtual machine, it starts up a virtual computer with its own 
operating system. In effect, virtual machines allow you to operate two or more computers 
on a single computer workstation. 



Zj 


Virtual machines depend on a technology known as virtualization. Unlike emulation, where 
hardware components such as the video card or processor are mimicked by software, 
virtualization maps the actual hardware resources to the virtual machine environment. This 
scheme ensures a clean separation between the virtual machine and the real computing 
system, while retaining most of the speed of the application as if it was running natively on 
the actual computer system. 
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Virtual machines in the classroom 

Virtual machines are ideal for quickly preparing a set of computer workstations with 
identical software configuration. Instead of completing a lengthy set of installation 
instructions, the classroom preparer only needs to uncompress a set of data files that 
define the virtual machine itself. 


Running virtual machines with the VMware Player application 

There are several companies that provide virtualization software. WebSphere Education is 
currently using VMware applications to create, manage, and run virtual machines in its 
classes. 

To reduce the software licensing costs to business partners, WebSphere Education 
courses use a free-of-charge solution, VMware Player. The only requirement placed upon 
the classroom preparer is the end-user license agreement for the VMware Player software. 
If the preparer does not agree to the EULA terms, contact the WebSphere Education 
engagement manager to discuss alternatives to the VMware application. 


Additional requirements with VMware Player 

In order to map the existing hardware devices to the virtual machine, the VMware Player 
application requires direct access to the system resources, such as the network adapter. 

Listed below are common issues associated with running a classroom environment with 
virtual machines and VMware Player software. 

• The student workstation needs to support two instances of the operating system, one 
for the physical (host) machine and one for the virtual machine (guest). Such a 
configuration places additional burden on memory and processor resources. 

• The VMware Player application relies on custom network drivers. The classroom 
preparer must have administrator-level privileges within the Windows operating system 
in order to install the software. 

• In bridged networking mode, a running copy of the virtual machine (guest) appears as 
a real computer on the network. Certain classrooms with strict computer network 
security policies might not allow unauthorized hosts to appear on the network. 

If any of these issues arise during the lab setup process, contact the WebSphere Education 
engagement manager to discuss workarounds. 
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